home *** CD-ROM | disk | FTP | other *** search
/ Aminet 34 / Aminet 34 (2000)(Schatztruhe)[!][Dec 1999].iso / Aminet / misc / emu / warpsnes.readme < prev   
Text File  |  1999-11-05  |  15KB  |  376 lines
  1. Short:    SNES Emulator for PowerPC (WarpUP) V4.1
  2. Author:   MagicSN@Birdland.es.bawue.de (Amiga Port), chinoclast@softhome.net (Sound Code), Jeremy Koot and Gary Henderson (original Unix Version)
  3. Uploader: MagicSN@Birdland.es.bawue.de
  4. Type:     misc/emu
  5.  
  6. New in V4.1:
  7.  
  8. - Included changes of SNES9x 1.25 sources
  9. - Small bugfix in joypad code
  10. - SPC700_C compiler flag enabled finally (like in Linux Version of SNES9x)
  11. - APU enabled by default (setting controlled by -sound/-nosound)
  12.  
  13. New in V4.0:
  14.  
  15. Spotlight --- tadaaaa --- major Version Jump:
  16.  
  17. V3.5a still based on SNES9x 1.10 Sources, V4.0 bases on:
  18.  
  19. * SNES9x 1.23 Sources *
  20.  
  21. Yeah, the latest ones from SNES9x !!! :)
  22.  
  23. New in V3.5a:
  24.  
  25. - Crash on exit was not the fault of SNES9xGUI, but of WarpSNES...
  26.   i found the bug and fixed it (on 3.5 it only appeared, if you
  27.   had sound enabled...). Now everything is perfect. Have fun.
  28.   Still AHI Code, faster Paula-Code not yet done.
  29.  
  30. New in V3.5:
  31.  
  32. - Sound Support !!! (Thanks go to chinoclast@softhome.net for his
  33.   GREAT Help in coding the sound stuff... actually it was more him
  34.   then me who coded the Sound... :) )
  35. - Added latest version of SNES9xGUI (Sadly it seems to crash on exit,
  36.   because of this i also added the old version)
  37.  
  38. Options for AHI-Sound:
  39.  
  40. -nosound: Switch off Sound (Default: Sound is on)
  41. -soundskip: values 0-3, only if sound is disabled
  42. -soundquality:
  43.  
  44. 0 - off
  45. 1 - 8192
  46. 2 - 11025
  47. 3 - 16500
  48. 4 - 22050 (default)
  49. 5 - 29300
  50. 6 - 33600
  51. 7 - 44000
  52.  
  53. Try a bit around what produces the best output !!! Also try
  54. around with your AHI settings. Usually GOOD is:
  55.  
  56. * Paula = Set frequency as high as possible
  57. * Sound Board = Set frequency to EXACTLY the one set in soundquality,
  58.                 for example 22050
  59.  
  60. If the sound jerks, play around with the settings !!!
  61.  
  62. You can use a different AHI Unit by using
  63.  
  64. -ahiunit (Default=0)
  65.  
  66. -stereo (default)
  67. -mono
  68. -buffersize: 4096-32768 (default: 16384)
  69.  
  70. (Try playing around with this too... i think the default gives the
  71. best results)
  72.  
  73. Important note to owners of Soundboards:
  74.  
  75. Appearently it does not work nice with Soundboard (at least not with
  76. my Prelude). It only jerks. The same happens when i use my Soundboard
  77. with Abuse 68k. I do not know if the hardware or the AHI Driver is
  78. the problem.
  79.  
  80. There exists a
  81.  
  82. -prelude
  83.  
  84. Parameter for Prelude native sound. Not yet working in this version
  85. of WarpSNES, use AHI !!!
  86.  
  87. The next version hopefully will also support SNES9x 1.18e changes. But
  88. i wanted to finish sound-support first !!!
  89.  
  90. New in last version:
  91.  
  92. - Removed the AGA Speedup again, as it was incompatible with some games (actually
  93.   a LOT of games). These games then only crashed, even if called on a GFX Board
  94.   Screen. I now provided two versions of the executable, WarpSNES without the
  95.   AGA speedup, WarpSNES.old with it (but not all games run on WarpSNES.old).
  96.   WarpSNES is V3.4, WarpSNES.old is V3.3.
  97.  
  98. New in last version:
  99.  
  100. - Major speedup for AGA (thanks to the author of SNES9xPPC for hints)
  101.   Note: For optimal speed it is still recommended to use a CD32 Joypad.
  102.   Keyboard controls are rather slow. But AGA display now runs at 80%
  103.   of GFX Board Display.
  104. - Now also works on systems without TCP/IP Stack installed (actually
  105.   removed TCP/IP part, as it still was not working... will reinsert it
  106.   later... now back to try to make the sound working :) )
  107.  
  108. New in last version:
  109.  
  110. - Adapted Sources to new-released SNES9x 1.10 (which means mainly that the DSP Emulation
  111.   improved so that more games run now, MarioKart *nearly* runs fine now)
  112. - Changed Joypad Buttons, so that they come closer to the real SNES
  113. - -minimal option added to switch of keyboard code with exception of ESC (did not
  114.   give much of a speedup, though)
  115. - Network Support of 1.10 SNES9x (Untested, might not work)
  116. - No unzip support of 1.10 SNES9x (but gzip Support works like always)
  117. - Sound still does not work, sorry, also no ASM Optimizations yet... (maybe next 
  118.   version...). If anybody has an idea about the sound, contact me :) 
  119. - fps should now show the real value for frameskip
  120. - added a 4th GUI sent to me by the author, Johan Lundell (ghwerig@home.se).
  121.   Thanks for the Support :)
  122.  
  123. - Last version:
  124.  
  125. - frameskip now works. Note: the fps counter will show the 
  126.  
  127.   Frames Displayed / second
  128.  
  129.   So the number will be much lower than your gaming feeling.
  130.   Somehow i am not sure if the number is displayed correct. If i
  131.   do -f 0 i get 36 fps, if i do -f 2 i get 15 fps, but the 15 fps
  132.   of -f 2 are definitely faster than the 36 fps :) The 36 fps are
  133.   correctly calculated however... somehow measuring goes strange
  134.   when frameskip is enabled... as the result looks much more like
  135.   50 fps than like 15 fps...
  136.  
  137.   Use -f 0 to play with every frame displayed.
  138.  
  139. - Included a new version of SNES9xgui
  140. - Included wsl GUI which by mistake was not included last time (instead
  141.   theguis.lha included an old version of WarpSNES last time... shame on me :) )
  142.  
  143. New in last versions:
  144.  
  145. - Lots of bugfixes
  146. - If Subdirectory Snapshots exists, saving works
  147. - Added 3 GUI's sent to me by different people. Use the one you like best :)
  148.   Thanks to Andreas Falkenhahn, Rune J. Keller and Sinan Gurkan for the
  149.   GUI's (personally i prefer snes9xgui from Andreas Falkenhahn)
  150. - Note about the GUIs: The GUI of Andreas Falkenhahn sets the name of the
  151.   Emulator (it works with both WarpSNES and SNES9x for 68k) in a Tooltype.
  152.   The GUI of Sinan Gurkan assumes the name to be WarpSNES, the GUI of Rune J.
  153.   Keller enables the user to choose a name.
  154. - Another note: Even if Andreas' GUI display's .zip'ed files, WarpSNES does not
  155.   run these. It can run gzip, not zip !!! That was a misunderstanding between
  156.   me and Andreas, hopefully fixed in the next version of the GUI :)
  157. - BTW: WarpSNES now also runs .fig format, not only .smc !!!
  158. - 15/16 Bit for *all* GFX Boards with WORKING Transparency effects
  159. - Mousepointer is switched off during the game runs
  160. - Still no sound, sadly. Hopefully next version :)
  161.  
  162. Notes:
  163.  
  164. - -speedhack gives 1-2 extra fps, but does not work with all games
  165. - as long as sound does not work -nosound is also useful, gives 3-4 extra
  166.   fps normally
  167. - 16 Bit looks much better than 15 Bit, and is not slower
  168. - 256*256 Screenmodes enable a special optimization that gives 1 extra fps
  169. - 15/16 Bit is only recommended for PPC 604e + Zorro III Boards, it really
  170.   pushes your system to its limits (on my system Earthworm Jim runs with
  171.   -speedhack -nosound on a 256*256 16 Bit Mode - RGB16PC - at around
  172.   24-25 fps... probably on a GFX Board without Byte-Swapping 16 Bit is 
  173.   faster...)
  174. - Byteswapping for 15/16 Bit is MUCH optimized. If anyone thinks he can
  175.   do better, contact me :) A piece of code to load 8 Bytes at once from
  176.   memory, Byteswap them and store them to memory, using lfdu/stfdu, would
  177.   be nice... currently i am using "4-Bytes at once".
  178.  
  179. New in the last version:
  180.  
  181. - "Wrong-Colors-Bug" of the first version (the colors looked dull at best)
  182.   fixed.
  183. - Experimental 16 Bit Support integrated. Transparency currently lets things
  184.   look in very strange colors (Transparency can be toggled on/off by pressing
  185.   F10). 16 Bit currently only works on GFX Boards with RGB16PC GFX Modes (for
  186.   example Picasso IV or Piccolo SD64). I do NOT guarantee that you won't get
  187.   crashes in 16 Bit mode, activate it with -hicolor.
  188. - stretch currently does not work (but why anyways, on Amiga you can do a
  189.   screenmode the size that you get Fullscreen !!!)
  190. - hires support added (activate it with -hires)
  191. - snes: assign is not needed anymore
  192. - Loading of Compressed Files is now supported (use gzip to pack an Image
  193.   File, gzip should be on Aminet, and no, gzip is NOT the same like zip !!!)
  194.   The loading of the packed image files is very fast, as it is PPC Boosted :)
  195.   You then don't need the depacked images anymore on your harddrive. The
  196.   Emulator depacks them to RAM and starts them... :) Thanks to zlib...
  197.  
  198. If ANYBODY has an idea why 16 Bit stuff looks that strange, please tell me !!!
  199. I will then add the 16 Bit support for the other GFX Boards, also... hopefully
  200. the next versionwill also have sound-support. I also hope that till the next
  201. version Phase 5 have ruled out the problems with their A1200-FlashROM-Software.
  202.  
  203. BTW: Remember to raise the stack to a higher value.
  204.  
  205. WarpSNES Documentation
  206. ======================
  207.  
  208. Games reported to run/not to run:
  209. ---------------------------------
  210.  
  211. Game            Runs ?          Hardware                    fps
  212. ----            ------          --------                    ---
  213.  
  214. Earthworm Jim   yes             150 MHz 604e + Picasso IV   27
  215. R-Type III      yes             150 MHz 604e + Picasso IV   32
  216. Mariokarts      no              150 MHz 604e + Picasso IV   --
  217. Ranma 1/2       yes             150 MHz 604e + Picasso IV   30
  218. Uniracers       yes             150 MHz 604e + Picasso IV   28
  219. Final Fantasy 5 yes             150 MHz 604e + Picasso IV   32
  220.  
  221. For the AGA users among us, i did also some AGA tests.
  222.  
  223. Earthworm Jim   yes             150 MHz 604e + AGA          21
  224. R-Type III      yes             150 MHz 604e + AGA          23
  225.  
  226. WarpSNES is the first SNES Emulator for the PowerPC. It is really fast.
  227. WarpSNES needs WarpUP V12 and the rtgmaster.library to run. If you want
  228. Joystick/Joypad Support, you should also have the lowlevel.library.
  229.  
  230. An assign snes: has to exist.
  231.  
  232. WarpSNES bases on the great SNES9x code by Jeremy Koot and Gary Henderson.
  233.  
  234. At this place the copyright notice:
  235.  
  236. /*
  237.  * Snes9x - Portable Super Nintendo Entertainment System (TM) emulator.
  238.  *
  239.  * (c) Copyright 1996, 1997, 1998 Gary Henderson (gary@daniver.demon.co.uk) and
  240.  *                                Jerremy Koot (jkoot@euronet.nl)
  241.  *
  242.  * Super FX C emulator code
  243.  * (c) Copyright 1997, 1998 Lestat (lstat@hotmail.com) and
  244.  *                          Gary Henderson.
  245.  * Super FX assembler emulator code (c) Copyright 1998 zsKnight and _Demo_.
  246.  *
  247.  * DSP1 emulator code (c) Copyright 1998 Lestat and Gary Henderson.
  248.  * DOS port code contains the works of other authors. See headers in
  249.  * individual files.
  250.  *
  251.  * Permission to use, copy, modify and distribute Snes9x in both binary and
  252.  * source form, for non-commercial purposes, is hereby granted without fee,
  253.  * providing that this license information and copyright notice appear with
  254.  * all copies and any derived work.
  255.  *
  256.  * This software is provided 'as-is', without any express or implied
  257.  * warranty. In no event shall the authors be held liable for any damages
  258.  * arising from the use of this software.
  259.  *
  260.  * Snes9x is freeware for PERSONAL USE only. Commercial users should
  261.  * seek permission of the copyright holders first. Commercial use includes
  262.  * charging money for Snes9x or software derived from Snes9x.
  263.  *
  264.  * The copyright holders request that bug fixes and improvements to the code
  265.  * should be forwarded to them so everyone can benefit from the modifications
  266.  * in future versions.
  267.  *
  268.  * Super NES and Super Nintendo Entertainment System are trademarks of
  269.  * Nintendo Co., Limited and its subsidiary companies.
  270.  
  271. WarpSNES is AFAIK the first Amiga-port of SNES9x, and it is for PowerPC and
  272. damned fast !!! :)
  273.  
  274. And before someone asks: I know that the latest Flashrom Update for BlizzardPPC
  275. has problems with WarpUP. But this is not my problem, it is the problem of
  276. Phase 5. They should fix it. As long as it is not fixed i can only recommend
  277. NOT to update the FlashROM if you did not do it already and wait for a bugfixed
  278. version (the latest FlashROM has not only problems with WarpUP, but also with
  279. MUI and other things, so it is NOT recommended).
  280.  
  281. Now we come to the more detailed docs:
  282.  
  283. WarpSNES does not (yet...) support :
  284.  
  285. - Sound
  286. - Emulation of SNES Mouse
  287. - timing correction
  288.  
  289. If someone could help me with SNES Sound-Stuff (a coder of a 68k SNES Emulator
  290. maybe...), simply contact me. Also if you think you can do a nice GUI for it,
  291. contact me... at MagicSN@Birdland.es.bawue.de...
  292.  
  293. WarpSNES will get better versions later...
  294.  
  295. It has to be said, that i only can recommend using a CD32 Pad with this emulation.
  296. The keyboard movement sucks IMHO (you can't press several keys at the same time !!!)
  297. Play it with the CD32 Pad for the correct Console-Feeling...
  298.  
  299. The movement:
  300.  
  301. (Controller always means that you also can get this function by using a CD32 Controller
  302. instead of pressing a key...). I tried to stay as close as possible with the original
  303. SNES9x controls. A lot of functions are available on several keys.
  304.  
  305. Controller 1:
  306.  
  307. - cursor right or controller => Right
  308. - cursor left or controller => Left
  309. - cursor up or controller => Up
  310. - cursor down or controller => Down
  311. - Keypad Enter or controller "Play" => Start
  312. - Keypad Plus => Select
  313. - Insert or Controller => TL
  314. - Remove or Controller => TR
  315. - Home or Controller => X
  316. - End or Controller => Y
  317. - Pageup or Controller => A
  318. - Pagedown or Controller => B
  319.  
  320. Controller 2:
  321.  
  322. - K, Cursorblockright, Controller => Right
  323. - H, Cursorblockleft, Controller => Left
  324. - N,J,Cursorblockdown, Controller => Down
  325. - U,Cursorblockup,Controller => Up
  326. - Return, Controller => Start
  327. - Space => Select
  328. - A,V,Q,Controller => TL
  329. - Z,B,W,Controller => TR
  330. - S,M,E,Controller => X
  331. - X,,,R,Controller => Y
  332. - D,.,T,Controller => A
  333. - C,\,Y,Controller => B
  334.  
  335. - 1-5: No idea what this does, but something... ("BG_Forced")
  336. - 0: Disable HDMA
  337. - 8: Toggle BGLayering
  338. - 6: Swap Joypads
  339. - Backspace: Toggle DisableGraphicWindows
  340. - P: Pause
  341. - <: Something with frame-skip, probably does not yet have an effect
  342. - +: ""
  343. - left alt+f2 or del => load snapshot
  344. - left alt+f3 or help => save snapshot
  345.  
  346. New options not in the original Unix Version:
  347.  
  348. -nosecondjoy
  349.  
  350. disables second joypad for less contextswitches
  351.  
  352. -showfps
  353.  
  354. shows the fps rate on the game screen
  355.  
  356.  
  357. ============================= Archive contents =============================
  358.  
  359. Original  Packed Ratio    Date     Time    Name
  360. -------- ------- ----- --------- --------  -------------
  361.    60076   23528 60.8% 20-Sep-99 21:43:44  CHANGES
  362.     1639     767 53.2% 20-Sep-99 21:43:52  COPYRIGHT
  363.     9365    9365  0.0% 14-Oct-98 19:11:48  gui4.lha
  364.     1072     606 43.4% 20-Mar-99 22:43:02  PPC.notes
  365.    26620   10869 59.1% 20-Sep-99 21:43:58  PROBLEMS
  366.    31554   12933 59.0% 20-Sep-99 21:44:02  README.TXT
  367.    42188   42188  0.0% 20-Mar-99 22:47:36  SNES9xGUI1_9.lha
  368.      195     149 23.5% 20-Mar-99 22:47:12  SNES9xGUI1_9.readme
  369.    14418   14418  0.0% 21-Mar-99 20:00:20  SNESLauncher.lha
  370.     1656     905 45.3% 20-Mar-99 22:38:04  Sound.notes
  371.  1578836  198852 87.4% 20-Sep-99 21:39:22  WarpSNES
  372.    13616    5994 55.9% 20-Sep-99 21:40:58  WarpSNES.readme
  373.    47018   47018  0.0% 26-Aug-98 00:17:46  wsl.lha
  374. -------- ------- ----- --------- --------
  375.  1828253  367592 79.8% 21-Sep-99 13:17:52   13 files
  376.